home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 2 / Apprentice-Release2.iso / Source Code / C / System / Debugger FKEY 1.0 / Debugger FKEY about next >
Encoding:
Text File  |  1994-11-09  |  1.5 KB  |  22 lines  |  [ttro/ttxt]

  1. Debugger FKEY 1.0, ©1994 Reinder Verlinde
  2.  
  3. What it does:
  4.  
  5. This is an FKEY resource, which enables one to enter MacsBug by pressing -shift-0 (the zero on the top row of the keyboard). To make installing the FKEY easier I have ‘encapsulated’ it into a font suitcase. That way you can simply put it on your Fonts folder to install it. The custom icon and the Finder's get info box show that it isn’t really a FKEY.
  6.  
  7. Why to use it:
  8.  
  9. Firstly, it gives you a convenient way of entering Macsbug, which works on all Macintoshes. The advantage over other FKEYs which do the same thing is that this FKEY does not crash your Macintosh with an 'unimplemented trap' when you press it while no debugger is installed. The advantage over using -power on (on newer Macintoshes) or the interrupt button is that the FKEY is guaranteed to be called when the front application is the current process. Also, the interrupt button may be located at an inconvenient position. A disadvantage is that the FKEY is called only when the front process calls WaitNextEvent or GetNextEvent.
  10.  
  11. How it works:
  12.  
  13. It checks for the presence of absence of MacsBug by looking at the low-memory global MacJmp. If it is 0x00000000 or 0x80000000 it calls SysBeep, in all other cases it calls the _Debugger  trap. This is (almost) the recommended way to check for the presence of MacsBug. For details see the source code.
  14.  
  15. Distribution policy:
  16.  
  17. This FKEY may be freely distributed, as long as this accompanying documentation and the source code are distributed with it.
  18.  
  19. Version History:
  20.  
  21. 1.0 july 11, 1994.
  22.